package com.ltx.bugseeker.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;

import java.time.LocalDateTime;

/**
 * 用户实体类
 * 对应数据库中的用户表，包含用户的基本信息和状态
 * 
 * @author ltx
 * @since 2025-10-20 14:43:42
 */
@Data
@EqualsAndHashCode(callSuper = true)
@Accessors(chain = true)
@TableName("bs_user")
public class User extends BaseEntity {
    
    /**
     * 用户ID - 主键，自增
     */
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    
    /**
     * 手机号码 - 主要登录标识，唯一且必填
     */
    @TableField("phone")
    private String phone;
    
    /**
     * 密码 - 加密存储，首次登录后可设置
     */
    @TableField("password")
    private String password;
    
    /**
     * 用户名 - 显示名称，可选
     */
    @TableField("username")
    private String username;
    
    /**
     * 邮箱地址 - 可选，用于通知和找回密码
     */
    @TableField("email")
    private String email;
    
    /**
     * 是否已设置密码 - 标识用户是否完成首次密码设置
     */
    @TableField("password_set")
    private Boolean passwordSet;
    
    /**
     * 真实姓名
     */
    @TableField("real_name")
    private String realName;
    
    /**
     * 用户头像URL
     */
    @TableField("avatar")
    private String avatar;
    
    /**
     * 用户角色
     * 1-管理员, 2-测试经理, 3-测试工程师, 4-开发工程师, 5-项目经理
     */
    @TableField("role")
    private Integer role;
    
    /**
     * 用户状态
     * 1-正常, 2-禁用, 3-锁定
     */
    @TableField("status")
    private Integer status;
    
    /**
     * 最后登录时间
     */
    @TableField("last_login_time")
    private LocalDateTime lastLoginTime;
    
    /**
     * 最后登录IP
     */
    @TableField("last_login_ip")
    private String lastLoginIp;
    
    /**
     * 登录失败次数 - 用于账户锁定策略
     */
    @TableField("login_fail_count")
    private Integer loginFailCount;
    
    /**
     * 账户锁定时间 - 登录失败次数过多时锁定到此时间
     */
    @TableField("lock_time")
    private LocalDateTime lockTime;
    
    /**
     * 创建时间 - 自动填充
     */
    @TableField(value = "create_time", fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    
    /**
     * 更新时间 - 自动填充
     */
    @TableField(value = "update_time", fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
    
    /**
     * 创建人ID
     */
    @TableField("create_by")
    private Long createBy;
    
    /**
     * 更新人ID
     */
    @TableField("update_by")
    private Long updateBy;
    
    /**
     * 逻辑删除标识 - 0未删除，1已删除
     */
    @TableLogic
    @TableField("deleted")
    private Integer deleted;
    
    /**
     * 备注信息
     */
    @TableField("remark")
    private String remark;
}